##############################################################################
###+-------+##################################################################
#+-| CLEAR |-------------------------------------+############################
#| +-------+ The CLEAR command clears the screen |############################
#+-----------------------------------------------+############################
##############################################################################
##############################################################################
#+--| Syntax |---+############################################################
#|     CLEAR     |############################################################
#+---------------+############################################################
##############################################################################
##############################################################################
#########+---| Description |----------------------------------------+#########
#########| CLEAR does not go through any of the screen I/O systems. |#########
#########| This means that the output of the CLEAR command can not  |#########
#########| be redirected throught the scrn_dos, scrn_bios or the    |#########
#########| scrn_direct procedures.                                  |#########
#########| -------------------------------------------------------- |#########
#########| To clear pending GETs, use the CLEAR GETS command. CLEAR |#########
#########| does not respect the status of the SET CONSOLE flag.     |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 1 |-------------------------------------------+#########
#########| *    Print some text, then clear the screen.             |#########
#########|                                                          |#########
#########| ? text_block                                             |#########
#########| WAIT                                                     |#########
#########| CLEAR                                                    |#########
#########+----------------------------------------------------------+#########
##############################################################################
##############################################################################
#########+--| Example 2 |-------------------------------------------+#########
#########| *    Because the CLEAR command is independent of the     |#########
#########| *    display I/O systems, SET CONSOLE flag is ignored    |#########
#########|                                                          |#########
#########| SET CONSOLE OFF                                          |#########
#########| CLEAR                       && Screen is still cleared.  |#########
#########+----------------------------------------------------------+#########
##############################################################################